Node / meshtastic / Meshtastic-Android / files / core / repository / src / commonMain / kotlin / org / meshtastic / core / repository / DeviceLinkRepository.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.repository

Tff7b72import T7ee787kotlinx.coroutines.flow.Flow

Tff7b72import T7ee787org.meshtastic.core.common.util.currentRegionCode

Tff7b72import T7ee787org.meshtastic.core.model.DeviceLink

T8b949e/**

* Provides msh.to device links resolved by the Meshtastic API (`/resource/deviceLinks`) and cached locally. Vendor and

* region-filtered marketplace links are shown on the device hardware detail view, plus a full directory.

*/

Tff7b72interface T56d364DeviceLinkRepository Tb4b4b4{

T8b949e/** Seeds the link table from the bundled snapshot if it is empty (fresh install, data clear, radio switch). */

Tff7b72suspend Tff7b72fun Td2a8ffensureImportedTb4b4b4(Tb4b4b4)

T8b949e/** Refreshes links from the API: upserts the resolved catalog and prunes short codes that no longer exist. */

Tff7b72suspend Tff7b72fun Td2a8ffreconcileTb4b4b4(Tb4b4b4)

T8b949e/**

* Links attached to a device's [platformioTarget], region-filtered and sorted with vendor links first. Returns an

* empty list when no links match.

*/

Tff7b72suspend Tff7b72fun Td2a8ffgetLinksForTargetTb4b4b4(Te6edf3platformioTargetTb4b4b4: Tffa657StringTb4b4b4, Te6edf3regionCodeTb4b4b4: Tffa657String Tff7b72= Te6edf3currentRegionCodeTb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3DeviceLinkTff7b72>

T8b949e/** All cached links, sorted by short code — backs the Settings "Device Links" directory. */

Tff7b72fun Td2a8ffobserveAllLinksTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3FlowTff7b72<Te6edf3ListTff7b72<Te6edf3DeviceLinkTff7b72>Tff7b72>

Tb4b4b4}